Signed-off-by: Elijah Greenstein <elijah.greenstein@canonical.com>
(cherry picked from commit 89c5bdb)

Signed-off-by: Elijah Greenstein <elijah.greenstein@canonical.com>
(cherry picked from commit 60b4948)

This commit removes a line that is out of date since the release of
MicroCloud 3.1.

Signed-off-by: Elijah Greenstein <elijah.greenstein@canonical.com>
(cherry picked from commit 097efd9)

Signed-off-by: Elijah Greenstein <elijah.greenstein@canonical.com>
(cherry picked from commit 300339e)

This commit brings docs into alignment with inclusive language standards
by replacing "see" (for example, "see <cross reference>") with
alternatives such as "refer to", "visit", and "consult".  It also seeks
to ensure consistency in punctuation by removing colons when cross
references appear mid-sentence. For example: "Refer to: <cross
reference> for details." becomes "Refer to <cross reference> for
details."

Signed-off-by: Elijah Greenstein <elijah.greenstein@canonical.com>
(cherry picked from commit 07c96d4)

Change "e.g." to "for example".

Signed-off-by: Elijah Greenstein <elijah.greenstein@canonical.com>
(cherry picked from commit c3199b9)

Signed-off-by: Minae Lee <minae.lee@canonical.com>
(cherry picked from commit b3600ad)

The CLI "cheat sheet" describes commands and therefore corresponds more
to reference material than a goal-oriented how-to guide.

This commit moves the page, updates the CLI documentation title to
reflect its new category (reference), updates the label for the
top-level header, and provides a redirect to prevent broken links.

Signed-off-by: Elijah Greenstein <elijah.greenstein@canonical.com>
(cherry picked from commit e342cb5)

Signed-off-by: Julian Pelizäus <julian.pelizaeus@canonical.com>
(cherry picked from commit 8778a51)

snap tends to perform a retry itself.
Also due to current state of runners retrying might not anymore be required.

The retry call is still left for apt operations.

Signed-off-by: Julian Pelizäus <julian.pelizaeus@canonical.com>
(cherry picked from commit 1258291)

Signed-off-by: Julian Pelizäus <julian.pelizaeus@canonical.com>
(cherry picked from commit 4625725)

This commit reorganizes the tutorials so that the more advanced
single-member tutorial follows the more basic multi-member tutorial.
This commit also seeks to draw attention to:

1. the different hardware and prerequisite knowledge required to
   complete each tutorial, and
1. the differences between these tutorials and the demands of a
   production environment (which requires a minimum of three physical
   machines).

Signed-off-by: Elijah Greenstein <elijah.greenstein@canonical.com>
(cherry picked from commit d310340)

This commit corrects the reference label to point to the single-member
tutorial, which is the tutorial that demonstrates MicroCloud setup on a
physical machine.

Signed-off-by: Elijah Greenstein <elijah.greenstein@canonical.com>
(cherry picked from commit f384028)

This commit revises the explanation summary to emphasize that the guides
connections between MicroCloud and other component software (LXD,
Ceph, OVN).

Signed-off-by: Elijah Greenstein <elijah.greenstein@canonical.com>
(cherry picked from commit 4715b0a)

This commit groups related how-to guides together and provides short
summaries of each of those groups.

Signed-off-by: Elijah Greenstein <elijah.greenstein@canonical.com>
(cherry picked from commit e0566fa)

This commit moves the CLI description to the reference landing page.

Signed-off-by: Elijah Greenstein <elijah.greenstein@canonical.com>
(cherry picked from commit 1d552fe)

Signed-off-by: Minae Lee <minae.lee@canonical.com>
(cherry picked from commit ea8ab66)

This accommodates slower environments but especially join procedures with lots of necessary setup actions.
An example is setting up a MicroCloud with many OSDs.

Fixes canonical#1339.

Signed-off-by: Julian Pelizäus <julian.pelizaeus@canonical.com>
(cherry picked from commit 5a67e54)

Signed-off-by: Simon Deziel <simon.deziel@canonical.com>
(cherry picked from commit be4f94b)

…zizmor)

Signed-off-by: Simon Deziel <simon.deziel@canonical.com>
(cherry picked from commit 0e09d34)

…zmor)

Signed-off-by: Simon Deziel <simon.deziel@canonical.com>
(cherry picked from commit 8aa8496)

Signed-off-by: Simon Deziel <simon.deziel@canonical.com>
(cherry picked from commit 5a499c8)

Signed-off-by: Simon Deziel <simon.deziel@canonical.com>
(cherry picked from commit 814d36e)

Signed-off-by: Simon Deziel <simon.deziel@canonical.com>
(cherry picked from commit 3719126)

Signed-off-by: Simon Deziel <simon.deziel@canonical.com>
(cherry picked from commit 3b0bdd0)

Signed-off-by: Simon Deziel <simon.deziel@canonical.com>
(cherry picked from commit 9795f25)

Signed-off-by: Simon Deziel <simon.deziel@canonical.com>
(cherry picked from commit c218afa)

Signed-off-by: Simon Deziel <simon.deziel@canonical.com>
(cherry picked from commit a89be4a)

Signed-off-by: Simon Deziel <simon.deziel@canonical.com>
(cherry picked from commit 50ab661)